home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / djgpp / docs / gdb / gdb.i8 < prev    next >
Encoding:
GNU Info File  |  1994-07-26  |  44.7 KB  |  955 lines
  1. This is Info file ./gdb.info, produced by Makeinfo-1.52 from the input
  2. file gdb.texinfo.
  3.  
  4. START-INFO-DIR-ENTRY
  5. * Gdb::                         The GNU debugger.
  6. END-INFO-DIR-ENTRY
  7.    This file documents the GNU debugger GDB.
  8.  
  9.    This is Edition 4.12, January 1994, of `Debugging with GDB: the GNU
  10. Source-Level Debugger' for GDB Version 4.12.
  11.  
  12.    Copyright (C) 1988, '89, '90, '91, '92, '93 Free Software
  13. Foundation, Inc.
  14.  
  15.    Permission is granted to make and distribute verbatim copies of this
  16. manual provided the copyright notice and this permission notice are
  17. preserved on all copies.
  18.  
  19.    Permission is granted to copy and distribute modified versions of
  20. this manual under the conditions for verbatim copying, provided also
  21. that the entire resulting derived work is distributed under the terms
  22. of a permission notice identical to this one.
  23.  
  24.    Permission is granted to copy and distribute translations of this
  25. manual into another language, under the above conditions for modified
  26. versions.
  27.  
  28. 
  29. File: gdb.info,  Node: Installing GDB,  Next: Index,  Prev: Formatting Documentation,  Up: Top
  30.  
  31. Installing GDB
  32. **************
  33.  
  34.    GDB comes with a `configure' script that automates the process of
  35. preparing GDB for installation; you can then use `make' to build the
  36. `gdb' program.
  37.  
  38.    The GDB distribution includes all the source code you need for GDB in
  39. a single directory, whose name is usually composed by appending the
  40. version number to `gdb'.
  41.  
  42.    For example, the GDB version 4.12 distribution is in the `gdb-4.12'
  43. directory.  That directory contains:
  44.  
  45. `gdb-4.12/configure (and supporting files)'
  46.      script for configuring GDB and all its supporting libraries.
  47.  
  48. `gdb-4.12/gdb'
  49.      the source specific to GDB itself
  50.  
  51. `gdb-4.12/bfd'
  52.      source for the Binary File Descriptor library
  53.  
  54. `gdb-4.12/include'
  55.      GNU include files
  56.  
  57. `gdb-4.12/libiberty'
  58.      source for the `-liberty' free software library
  59.  
  60. `gdb-4.12/opcodes'
  61.      source for the library of opcode tables and disassemblers
  62.  
  63. `gdb-4.12/readline'
  64.      source for the GNU command-line interface
  65.  
  66. `gdb-4.12/glob'
  67.      source for the GNU filename pattern-matching subroutine
  68.  
  69. `gdb-4.12/mmalloc'
  70.      source for the GNU memory-mapped malloc package
  71.  
  72.    The simplest way to configure and build GDB is to run `configure'
  73. from the `gdb-VERSION-NUMBER' source directory, which in this example
  74. is the `gdb-4.12' directory.
  75.  
  76.    First switch to the `gdb-VERSION-NUMBER' source directory if you are
  77. not already in it; then run `configure'.  Pass the identifier for the
  78. platform on which GDB will run as an argument.
  79.  
  80.    For example:
  81.  
  82.      cd gdb-4.12
  83.      ./configure HOST
  84.      make
  85.  
  86. where HOST is an identifier such as `sun4' or `decstation', that
  87. identifies the platform where GDB will run.  (You can often leave off
  88. HOST; `configure' tries to guess the correct value by examining your
  89. system.)
  90.  
  91.    Running `configure HOST' and then running `make' builds the `bfd',
  92. `readline', `mmalloc', and `libiberty' libraries, then `gdb' itself.
  93. The configured source files, and the binaries, are left in the
  94. corresponding source directories.
  95.  
  96.    `configure' is a Bourne-shell (`/bin/sh') script; if your system
  97. does not recognize this automatically when you run a different shell,
  98. you may need to run `sh' on it explicitly:
  99.  
  100.      sh configure HOST
  101.  
  102.    If you run `configure' from a directory that contains source
  103. directories for multiple libraries or programs, such as the `gdb-4.12'
  104. source directory for version 4.12, `configure' creates configuration
  105. files for every directory level underneath (unless you tell it not to,
  106. with the `--norecursion' option).
  107.  
  108.    You can run the `configure' script from any of the subordinate
  109. directories in the GDB distribution if you only want to configure that
  110. subdirectory, but be sure to specify a path to it.
  111.  
  112.    For example, with version 4.12, type the following to configure only
  113. the `bfd' subdirectory:
  114.  
  115.      cd gdb-4.12/bfd
  116.      ../configure HOST
  117.  
  118.    You can install `gdb' anywhere; it has no hardwired paths.  However,
  119. you should make sure that the shell on your path (named by the `SHELL'
  120. environment variable) is publicly readable.  Remember that GDB uses the
  121. shell to start your program--some systems refuse to let GDB debug child
  122. processes whose programs are not readable.
  123.  
  124. * Menu:
  125.  
  126. * Separate Objdir::             Compiling GDB in another directory
  127. * Config Names::                Specifying names for hosts and targets
  128. * configure Options::           Summary of options for configure
  129.  
  130. 
  131. File: gdb.info,  Node: Separate Objdir,  Next: Config Names,  Up: Installing GDB
  132.  
  133. Compiling GDB in another directory
  134. ==================================
  135.  
  136.    If you want to run GDB versions for several host or target machines,
  137. you need a different `gdb' compiled for each combination of host and
  138. target.  `configure' is designed to make this easy by allowing you to
  139. generate each configuration in a separate subdirectory, rather than in
  140. the source directory.  If your `make' program handles the `VPATH'
  141. feature (GNU `make' does), running `make' in each of these directories
  142. builds the `gdb' program specified there.
  143.  
  144.    To build `gdb' in a separate directory, run `configure' with the
  145. `--srcdir' option to specify where to find the source.  (You also need
  146. to specify a path to find `configure' itself from your working
  147. directory.  If the path to `configure' would be the same as the
  148. argument to `--srcdir', you can leave out the `--srcdir' option; it is
  149. assumed.)
  150.  
  151.    For example, with version 4.12, you can build GDB in a separate
  152. directory for a Sun 4 like this:
  153.  
  154.      cd gdb-4.12
  155.      mkdir ../gdb-sun4
  156.      cd ../gdb-sun4
  157.      ../gdb-4.12/configure sun4
  158.      make
  159.  
  160.    When `configure' builds a configuration using a remote source
  161. directory, it creates a tree for the binaries with the same structure
  162. (and using the same names) as the tree under the source directory.  In
  163. the example, you'd find the Sun 4 library `libiberty.a' in the
  164. directory `gdb-sun4/libiberty', and GDB itself in `gdb-sun4/gdb'.
  165.  
  166.    One popular reason to build several GDB configurations in separate
  167. directories is to configure GDB for cross-compiling (where GDB runs on
  168. one machine--the host--while debugging programs that run on another
  169. machine--the target).  You specify a cross-debugging target by giving
  170. the `--target=TARGET' option to `configure'.
  171.  
  172.    When you run `make' to build a program or library, you must run it
  173. in a configured directory--whatever directory you were in when you
  174. called `configure' (or one of its subdirectories).
  175.  
  176.    The `Makefile' that `configure' generates in each source directory
  177. also runs recursively.  If you type `make' in a source directory such
  178. as `gdb-4.12' (or in a separate configured directory configured with
  179. `--srcdir=PATH/gdb-4.12'), you will build all the required libraries,
  180. and then build GDB.
  181.  
  182.    When you have multiple hosts or targets configured in separate
  183. directories, you can run `make' on them in parallel (for example, if
  184. they are NFS-mounted on each of the hosts); they will not interfere
  185. with each other.
  186.  
  187. 
  188. File: gdb.info,  Node: Config Names,  Next: configure Options,  Prev: Separate Objdir,  Up: Installing GDB
  189.  
  190. Specifying names for hosts and targets
  191. ======================================
  192.  
  193.    The specifications used for hosts and targets in the `configure'
  194. script are based on a three-part naming scheme, but some short
  195. predefined aliases are also supported.  The full naming scheme encodes
  196. three pieces of information in the following pattern:
  197.  
  198.      ARCHITECTURE-VENDOR-OS
  199.  
  200.    For example, you can use the alias `sun4' as a HOST argument, or as
  201. the value for TARGET in a `--target=TARGET' option.  The equivalent
  202. full name is `sparc-sun-sunos4'.
  203.  
  204.    The `configure' script accompanying GDB does not provide any query
  205. facility to list all supported host and target names or aliases.
  206. `configure' calls the Bourne shell script `config.sub' to map
  207. abbreviations to full names; you can read the script, if you wish, or
  208. you can use it to test your guesses on abbreviations--for example:
  209.  
  210.      % sh config.sub sun4
  211.      sparc-sun-sunos4.1.1
  212.      % sh config.sub sun3
  213.      m68k-sun-sunos4.1.1
  214.      % sh config.sub decstation
  215.      mips-dec-ultrix4.2
  216.      % sh config.sub hp300bsd
  217.      m68k-hp-bsd
  218.      % sh config.sub i386v
  219.      i386-unknown-sysv
  220.      % sh config.sub i786v
  221.      Invalid configuration `i786v': machine `i786v' not recognized
  222.  
  223. `config.sub' is also distributed in the GDB source directory
  224. (`gdb-4.12', for version 4.12).
  225.  
  226. 
  227. File: gdb.info,  Node: configure Options,  Prev: Config Names,  Up: Installing GDB
  228.  
  229. `configure' options
  230. ===================
  231.  
  232.    Here is a summary of the `configure' options and arguments that are
  233. most often useful for building GDB.  `configure' also has several other
  234. options not listed here.  *note : (configure.info)What Configure Does,
  235. for a full explanation of `configure'.
  236.  
  237.      configure [--help]
  238.                [--prefix=DIR]
  239.                [--srcdir=PATH]
  240.                [--norecursion] [--rm]
  241.                [--target=TARGET] HOST
  242.  
  243. You may introduce options with a single `-' rather than `--' if you
  244. prefer; but you may abbreviate option names if you use `--'.
  245.  
  246. `--help'
  247.      Display a quick summary of how to invoke `configure'.
  248.  
  249. `-prefix=DIR'
  250.      Configure the source to install programs and files under directory
  251.      `DIR'.
  252.  
  253. `--srcdir=PATH'
  254.      *Warning: using this option requires GNU `make', or another `make'
  255.      that implements the `VPATH' feature.*
  256.      Use this option to make configurations in directories separate
  257.      from the GDB source directories.  Among other things, you can use
  258.      this to build (or maintain) several configurations simultaneously,
  259.      in separate directories.  `configure' writes configuration
  260.      specific files in the current directory, but arranges for them to
  261.      use the source in the directory PATH.  `configure' creates
  262.      directories under the working directory in parallel to the source
  263.      directories below PATH.
  264.  
  265. `--norecursion'
  266.      Configure only the directory level where `configure' is executed;
  267.      do not propagate configuration to subdirectories.
  268.  
  269. `--rm'
  270.      *Remove* files otherwise built during configuration.
  271.  
  272. `--target=TARGET'
  273.      Configure GDB for cross-debugging programs running on the specified
  274.      TARGET.  Without this option, GDB is configured to debug programs
  275.      that run on the same machine (HOST) as GDB itself.
  276.  
  277.      There is no convenient way to generate a list of all available
  278.      targets.
  279.  
  280. `HOST ...'
  281.      Configure GDB to run on the specified HOST.
  282.  
  283.      There is no convenient way to generate a list of all available
  284.      hosts.
  285.  
  286. `configure' accepts other options, for compatibility with configuring
  287. other GNU tools recursively; but these are the only options that affect
  288. GDB or its supporting libraries.
  289.  
  290. 
  291. File: gdb.info,  Node: Index,  Prev: Installing GDB,  Up: Top
  292.  
  293. Index
  294. *****
  295.  
  296. * Menu:
  297.  
  298. * #:                                    Command Syntax.
  299. * $bpnum:                               Set Breaks.
  300. * $cdir:                                Source Path.
  301. * $cwd:                                 Source Path.
  302. * $_:                                   Convenience Vars.
  303. * $__:                                  Convenience Vars.
  304. * .:                                    M2 Scope.
  305. * .esgdbinit:                           Command Files.
  306. * .os68gdbinit:                         Command Files.
  307. * .vxgdbinit:                           Command Files.
  308. * /proc:                                Process Information.
  309. * @:                                    Arrays.
  310. * # in Modula-2:                        GDB/M2.
  311. * $$:                                   Value History.
  312. * $_ and info breakpoints:              Set Breaks.
  313. * $_ and info line:                     Machine Code.
  314. * $_, $__, and value history:           Memory.
  315. * $:                                    Value History.
  316. * breakpoint subroutine, remote:        Stub Contents.
  317. * heuristic-fence-post (MIPS):          MIPS Stack.
  318. * remotedebug, MIPS protocol:           MIPS Remote.
  319. * retransmit-timeout, MIPS protocol:    MIPS Remote.
  320. * timeout, MIPS protocol:               MIPS Remote.
  321. * vi style command editing:             Readline Vi Mode.
  322. * .gdbinit:                             Command Files.
  323. * COFF versus C++:                      Cplus expressions.
  324. * ECOFF and C++:                        Cplus expressions.
  325. * ELF/DWARF and C++:                    Cplus expressions.
  326. * ELF/stabs and C++:                    Cplus expressions.
  327. * XCOFF and C++:                        Cplus expressions.
  328. * GDB bugs, reporting:                  Bug Reporting.
  329. * {TYPE}:                               Expressions.
  330. * a.out and C++:                        Cplus expressions.
  331. * abbreviation:                         Command Syntax.
  332. * active targets:                       Active Targets.
  333. * add-symbol-file:                      Files.
  334. * add-syms:                             Renamed Commands.
  335. * AMD 29K register stack:               Registers.
  336. * AMD EB29K:                            Target Commands.
  337. * AMD29K via UDI:                       UDI29K Remote.
  338. * arguments (to your program):          Arguments.
  339. * artificial array:                     Arrays.
  340. * assembly instructions:                Machine Code.
  341. * assignment:                           Assignment.
  342. * attach:                               Attach.
  343. * attach:                               Attach.
  344. * automatic display:                    Auto Display.
  345. * automatic thread selection:           Threads.
  346. * b:                                    Set Breaks.
  347. * backtrace:                            Backtrace.
  348. * break:                                Set Breaks.
  349. * break ... thread THREADNO:            Thread Stops.
  350. * break in overloaded functions:        Debugging C plus plus.
  351. * breakpoint commands:                  Break Commands.
  352. * breakpoint conditions:                Conditions.
  353. * breakpoint numbers:                   Breakpoints.
  354. * breakpoint on memory address:         Breakpoints.
  355. * breakpoint on variable modification:  Breakpoints.
  356. * breakpoints:                          Breakpoints.
  357. * breakpoints and threads:              Thread Stops.
  358. * bt:                                   Backtrace.
  359. * bug criteria:                         Bug Criteria.
  360. * bug reports:                          Bug Reporting.
  361. * bugs in GDB:                          GDB Bugs.
  362. * c:                                    Continuing and Stepping.
  363. * C and C++:                            C.
  364. * C and C++ checks:                     C Checks.
  365. * C and C++ constants:                  C Operators.
  366. * C and C++ defaults:                   C Defaults.
  367. * C and C++ operators:                  C.
  368. * C++:                                  C.
  369. * C++ and object formats:               Cplus expressions.
  370. * C++ exception handling:               Debugging C plus plus.
  371. * C++ scope resolution:                 Variables.
  372. * C++ support, not in COFF:             Cplus expressions.
  373. * C++ symbol decoding style:            Print Settings.
  374. * C++ symbol display:                   Debugging C plus plus.
  375. * call:                                 Calling.
  376. * call overloaded functions:            Cplus expressions.
  377. * call stack:                           Stack.
  378. * calling functions:                    Calling.
  379. * calling make:                         Shell Commands.
  380. * casts, to view memory:                Expressions.
  381. * catch:                                Exception Handling.
  382. * catch exceptions:                     Frame Info.
  383. * cd:                                   Working Directory.
  384. * cdir:                                 Source Path.
  385. * checks, range:                        Type Checking.
  386. * checks, type:                         Checks.
  387. * checksum, for GDB remote:             Protocol.
  388. * clear:                                Delete Breaks.
  389. * clearing breakpoints, watchpoints:    Delete Breaks.
  390. * colon, doubled as scope operator:     M2 Scope.
  391. * colon-colon:                          M2 Scope.
  392. * colon-colon:                          Variables.
  393. * command files:                        Command Files.
  394. * command files:                        Hooks.
  395. * command line editing:                 Editing.
  396. * commands:                             Break Commands.
  397. * commands for C++:                     Debugging C plus plus.
  398. * commands to STDBUG (ST2000):          ST2000 Remote.
  399. * comment:                              Command Syntax.
  400. * compilation directory:                Source Path.
  401. * completion:                           Completion.
  402. * completion of quoted strings:         Completion.
  403. * condition:                            Conditions.
  404. * conditional breakpoints:              Conditions.
  405. * configuring GDB:                      Installing GDB.
  406. * confirmation:                         Messages/Warnings.
  407. * connect (to STDBUG):                  ST2000 Remote.
  408. * continue:                             Continuing and Stepping.
  409. * continuing:                           Continuing and Stepping.
  410. * continuing threads:                   Thread Stops.
  411. * control C, and remote debugging:      Bootstrapping.
  412. * controlling terminal:                 Input/Output.
  413. * convenience variables:                Convenience Vars.
  414. * core:                                 Files.
  415. * core dump file:                       Files.
  416. * core-file:                            Files.
  417. * CPU simulator:                        Simulator.
  418. * crash of debugger:                    Bug Criteria.
  419. * current directory:                    Source Path.
  420. * current thread:                       Threads.
  421. * cwd:                                  Source Path.
  422. * d:                                    Delete Breaks.
  423. * debugger crash:                       Bug Criteria.
  424. * debugging optimized code:             Compilation.
  425. * debugging stub, example:              Protocol.
  426. * debugging target:                     Targets.
  427. * define:                               Define.
  428. * delete:                               Delete Breaks.
  429. * delete breakpoints:                   Delete Breaks.
  430. * delete display:                       Auto Display.
  431. * delete environment:                   Renamed Commands.
  432. * deleting breakpoints, watchpoints:    Delete Breaks.
  433. * detach:                               Attach.
  434. * device:                               Hitachi Remote.
  435. * directories for source files:         Source Path.
  436. * directory:                            Source Path.
  437. * directory, compilation:               Source Path.
  438. * directory, current:                   Source Path.
  439. * dis:                                  Disabling.
  440. * disable:                              Disabling.
  441. * disable breakpoints:                  Disabling.
  442. * disable display:                      Auto Display.
  443. * disabled breakpoints:                 Disabling.
  444. * disassemble:                          Machine Code.
  445. * display:                              Auto Display.
  446. * display of expressions:               Auto Display.
  447. * do:                                   Selection.
  448. * document:                             Define.
  449. * documentation:                        Formatting Documentation.
  450. * down:                                 Selection.
  451. * down-silently:                        Selection.
  452. * download to H8/300 or H8/500:         Files.
  453. * download to Hitachi SH:               Files.
  454. * download to Nindy-960:                Files.
  455. * download to VxWorks:                  VxWorks Download.
  456. * dynamic linking:                      Files.
  457. * eb.log:                               Remote Log.
  458. * EB29K board:                          EB29K Remote.
  459. * EBMON:                                Comms (EB29K).
  460. * echo:                                 Output.
  461. * editing:                              Editing.
  462. * editing-mode:                         Readline Init Syntax.
  463. * emacs:                                Emacs.
  464. * enable:                               Disabling.
  465. * enable breakpoints:                   Disabling.
  466. * enable display:                       Auto Display.
  467. * enabled breakpoints:                  Disabling.
  468. * end:                                  Break Commands.
  469. * entering numbers:                     Numbers.
  470. * environment (of your program):        Environment.
  471. * error on valid input:                 Bug Criteria.
  472. * event designators:                    Event Designators.
  473. * examining data:                       Data.
  474. * examining memory:                     Memory.
  475. * exception handlers:                   Frame Info.
  476. * exception handlers:                   Exception Handling.
  477. * exceptionHandler:                     Bootstrapping.
  478. * exec-file:                            Files.
  479. * executable file:                      Files.
  480. * exiting GDB:                          Quitting GDB.
  481. * expansion:                            History Interaction.
  482. * expressions:                          Expressions.
  483. * expressions in C or C++:              C.
  484. * expressions in C++:                   Cplus expressions.
  485. * expressions in Modula-2:              Modula-2.
  486. * f:                                    Selection.
  487. * fatal signal:                         Bug Criteria.
  488. * fatal signals:                        Signals.
  489. * fg:                                   Continuing and Stepping.
  490. * file:                                 Files.
  491. * finish:                               Continuing and Stepping.
  492. * flinching:                            Messages/Warnings.
  493. * floating point:                       Floating Point Hardware.
  494. * floating point registers:             Registers.
  495. * floating point, MIPS remote:          MIPS Remote.
  496. * flush_i_cache:                        Bootstrapping.
  497. * focus of debugging:                   Threads.
  498. * foo:                                  Symbol Errors.
  499. * format options:                       Print Settings.
  500. * formatted output:                     Output Formats.
  501. * Fortran:                              Summary.
  502. * forward-search:                       Search.
  503. * frame:                                Frames.
  504. * frame:                                Selection.
  505. * frame number:                         Frames.
  506. * frame pointer:                        Frames.
  507. * frameless execution:                  Frames.
  508. * g++:                                  C.
  509. * GDB reference card:                   Formatting Documentation.
  510. * GDBHISTFILE:                          History.
  511. * gdbserver:                            Server.
  512. * getDebugChar:                         Bootstrapping.
  513. * GNU C++:                              C.
  514. * h:                                    Help.
  515. * H8/300 or H8/500 download:            Files.
  516. * H8/300 or H8/500 simulator:           Simulator.
  517. * handle:                               Signals.
  518. * handle_exception:                     Stub Contents.
  519. * handling signals:                     Signals.
  520. * help:                                 Help.
  521. * help target:                          Target Commands.
  522. * help user-defined:                    Define.
  523. * history expansion:                    History.
  524. * history file:                         History.
  525. * history number:                       Value History.
  526. * history save:                         History.
  527. * history size:                         History.
  528. * history substitution:                 History.
  529. * Hitachi SH download:                  Files.
  530. * Hitachi SH simulator:                 Simulator.
  531. * horizontal-scroll-mode:               Readline Init Syntax.
  532. * i:                                    Help.
  533. * i/o:                                  Input/Output.
  534. * i386:                                 Remote Serial.
  535. * i386-stub.c:                          Remote Serial.
  536. * i960:                                 i960-Nindy Remote.
  537. * ignore:                               Conditions.
  538. * ignore count (of breakpoint):         Conditions.
  539. * INCLUDE_RDB:                          VxWorks Remote.
  540. * info:                                 Help.
  541. * info address:                         Symbols.
  542. * info all-registers:                   Registers.
  543. * info args:                            Frame Info.
  544. * info breakpoints:                     Set Breaks.
  545. * info catch:                           Frame Info.
  546. * info convenience:                     Renamed Commands.
  547. * info copying:                         Renamed Commands.
  548. * info directories:                     Renamed Commands.
  549. * info display:                         Auto Display.
  550. * info editing:                         Renamed Commands.
  551. * info f:                               Frame Info.
  552. * info files:                           Files.
  553. * info float:                           Floating Point Hardware.
  554. * info frame:                           Show.
  555. * info frame:                           Frame Info.
  556. * info functions:                       Symbols.
  557. * info history:                         Renamed Commands.
  558. * info line:                            Machine Code.
  559. * info locals:                          Frame Info.
  560. * info proc:                            Process Information.
  561. * info proc id:                         Process Information.
  562. * info proc mappings:                   Process Information.
  563. * info proc status:                     Process Information.
  564. * info proc times:                      Process Information.
  565. * info program:                         Stopping.
  566. * info registers:                       Registers.
  567. * info s:                               Backtrace.
  568. * info set:                             Help.
  569. * info share:                           Files.
  570. * info sharedlibrary:                   Files.
  571. * info signals:                         Signals.
  572. * info source:                          Show.
  573. * info source:                          Symbols.
  574. * info sources:                         Symbols.
  575. * info stack:                           Backtrace.
  576. * info target:                          Files.
  577. * info targets:                         Renamed Commands.
  578. * info terminal:                        Input/Output.
  579. * info threads:                         Threads.
  580. * info types:                           Symbols.
  581. * info values:                          Renamed Commands.
  582. * info variables:                       Symbols.
  583. * info version:                         Renamed Commands.
  584. * info warranty:                        Renamed Commands.
  585. * info watchpoints:                     Set Watchpoints.
  586. * inheritance:                          Debugging C plus plus.
  587. * init file:                            Command Files.
  588. * init file name:                       Command Files.
  589. * initial frame:                        Frames.
  590. * innermost frame:                      Frames.
  591. * inspect:                              Data.
  592. * installation:                         Installing GDB.
  593. * instructions, assembly:               Machine Code.
  594. * Intel:                                Remote Serial.
  595. * interaction, readline:                Readline Interaction.
  596. * internal GDB breakpoints:             Set Breaks.
  597. * interrupt:                            Quitting GDB.
  598. * interrupting remote programs:         Debug Session.
  599. * interrupting remote targets:          Bootstrapping.
  600. * invalid input:                        Bug Criteria.
  601. * jump:                                 Jumping.
  602. * kill:                                 Kill Process.
  603. * l:                                    List.
  604. * languages:                            Languages.
  605. * latest breakpoint:                    Set Breaks.
  606. * leaving GDB:                          Quitting GDB.
  607. * linespec:                             List.
  608. * list:                                 List.
  609. * listing machine instructions:         Machine Code.
  610. * load:                                 Files.
  611. * log file for EB29K:                   Remote Log.
  612. * m680x0:                               Remote Serial.
  613. * m68k-stub.c:                          Remote Serial.
  614. * machine instructions:                 Machine Code.
  615. * maint info breakpoints:               Set Breaks.
  616. * maint print psymbols:                 Symbols.
  617. * maint print symbols:                  Symbols.
  618. * make:                                 Shell Commands.
  619. * mapped:                               Files.
  620. * mark-modified-lines:                  Readline Init Syntax.
  621. * member functions:                     Cplus expressions.
  622. * memory tracing:                       Breakpoints.
  623. * memory, viewing as typed object:      Expressions.
  624. * memory-mapped symbol file:            Files.
  625. * memset:                               Bootstrapping.
  626. * MIPS remotedebug protocol:            MIPS Remote.
  627. * MIPS boards:                          MIPS Remote.
  628. * MIPS remote floating point:           MIPS Remote.
  629. * MIPS stack:                           MIPS Stack.
  630. * Modula-2:                             Modula-2.
  631. * Modula-2 built-ins:                   M2 Operators.
  632. * Modula-2 checks:                      M2 Checks.
  633. * Modula-2 constants:                   Built-In Func/Proc.
  634. * Modula-2 defaults:                    M2 Defaults.
  635. * Modula-2 operators:                   M2 Operators.
  636. * Modula-2, deviations from:            Deviations.
  637. * Motorola 680x0:                       Remote Serial.
  638. * multiple targets:                     Active Targets.
  639. * multiple threads:                     Threads.
  640. * n:                                    Continuing and Stepping.
  641. * names of symbols:                     Symbols.
  642. * namespace in C++:                     Cplus expressions.
  643. * negative breakpoint numbers:          Set Breaks.
  644. * New SYSTAG:                           Threads.
  645. * next:                                 Continuing and Stepping.
  646. * nexti:                                Continuing and Stepping.
  647. * ni:                                   Continuing and Stepping.
  648. * Nindy:                                i960-Nindy Remote.
  649. * number representation:                Numbers.
  650. * numbers for breakpoints:              Breakpoints.
  651. * object formats and C++:               Cplus expressions.
  652. * online documentation:                 Help.
  653. * optimized code, debugging:            Compilation.
  654. * outermost frame:                      Frames.
  655. * output:                               Output.
  656. * output formats:                       Output Formats.
  657. * overloading:                          Breakpoint Menus.
  658. * overloading in C++:                   Debugging C plus plus.
  659. * packets, reporting on stdout:         Protocol.
  660. * partial symbol dump:                  Symbols.
  661. * patching binaries:                    Patching.
  662. * path:                                 Environment.
  663. * pauses in output:                     Screen Size.
  664. * pipes:                                Starting.
  665. * pointer, finding referent:            Print Settings.
  666. * prefer-visible-bell:                  Readline Init Syntax.
  667. * print:                                Data.
  668. * print settings:                       Print Settings.
  669. * printf:                               Output.
  670. * printing data:                        Data.
  671. * process image:                        Process Information.
  672. * prompt:                               Prompt.
  673. * protocol, GDB remote serial:          Protocol.
  674. * ptype:                                Symbols.
  675. * putDebugChar:                         Bootstrapping.
  676. * pwd:                                  Working Directory.
  677. * q:                                    Quitting GDB.
  678. * quit:                                 Quitting GDB.
  679. * quotes in commands:                   Completion.
  680. * quoting names:                        Symbols.
  681. * raise exceptions:                     Exception Handling.
  682. * range checking:                       Type Checking.
  683. * rbreak:                               Set Breaks.
  684. * reading symbols immediately:          Files.
  685. * readline:                             Editing.
  686. * readnow:                              Files.
  687. * redirection:                          Input/Output.
  688. * reference card:                       Formatting Documentation.
  689. * reference declarations:               Cplus expressions.
  690. * register stack, AMD29K:               Registers.
  691. * registers:                            Registers.
  692. * regular expression:                   Set Breaks.
  693. * reloading symbols:                    Messages/Warnings.
  694. * remote connection without stubs:      Server.
  695. * remote debugging:                     Remote.
  696. * remote programs, interrupting:        Debug Session.
  697. * remote serial debugging summary:      Debug Session.
  698. * remote serial debugging, overview:    Remote Serial.
  699. * remote serial protocol:               Protocol.
  700. * remote serial stub:                   Stub Contents.
  701. * remote serial stub list:              Remote Serial.
  702. * remote serial stub, initialization:   Stub Contents.
  703. * remote serial stub, main routine:     Stub Contents.
  704. * remote stub, example:                 Protocol.
  705. * remote stub, support routines:        Bootstrapping.
  706. * repeating commands:                   Command Syntax.
  707. * reporting bugs in GDB:                GDB Bugs.
  708. * reset:                                Nindy Reset.
  709. * response time, MIPS debugging:        MIPS Stack.
  710. * resuming execution:                   Continuing and Stepping.
  711. * RET:                                  Command Syntax.
  712. * return:                               Returning.
  713. * returning from a function:            Returning.
  714. * reverse-search:                       Search.
  715. * run:                                  Starting.
  716. * running:                              Starting.
  717. * running 29K programs:                 EB29K Remote.
  718. * running VxWorks tasks:                VxWorks Attach.
  719. * s:                                    Continuing and Stepping.
  720. * saving symbol table:                  Files.
  721. * scope:                                M2 Scope.
  722. * search:                               Search.
  723. * searching:                            Search.
  724. * selected frame:                       Stack.
  725. * serial connections, debugging:        Protocol.
  726. * serial device, Hitachi micros:        Hitachi Remote.
  727. * serial line speed, Hitachi micros:    Hitachi Remote.
  728. * serial line, target remote:           Debug Session.
  729. * serial protocol, GDB remote:          Protocol.
  730. * set addressprint:                     Renamed Commands.
  731. * set args:                             Arguments.
  732. * set array-max:                        Renamed Commands.
  733. * set arrayprint:                       Renamed Commands.
  734. * set asm-demangle:                     Renamed Commands.
  735. * set caution:                          Renamed Commands.
  736. * set check:                            Type Checking.
  737. * set check:                            Range Checking.
  738. * set check range:                      Range Checking.
  739. * set check type:                       Type Checking.
  740. * set complaints:                       Messages/Warnings.
  741. * set confirm:                          Messages/Warnings.
  742. * set demangle:                         Renamed Commands.
  743. * set demangle-style:                   Print Settings.
  744. * set editing:                          Editing.
  745. * set environment:                      Environment.
  746. * set height:                           Screen Size.
  747. * set history expansion:                History.
  748. * set history filename:                 History.
  749. * set history save:                     History.
  750. * set history size:                     History.
  751. * set history write:                    Renamed Commands.
  752. * set language:                         Manually.
  753. * set listsize:                         List.
  754. * set mipsfpu off:                      MIPS Remote.
  755. * set prettyprint:                      Renamed Commands.
  756. * set print address:                    Print Settings.
  757. * set print array:                      Print Settings.
  758. * set print asm-demangle:               Print Settings.
  759. * set print demangle:                   Print Settings.
  760. * set print elements:                   Print Settings.
  761. * set print fast-symbolic-addr:         Print Settings.
  762. * set print max-symbolic-offset:        Print Settings.
  763. * set print object:                     Print Settings.
  764. * set print pretty:                     Print Settings.
  765. * set print sevenbit-strings:           Print Settings.
  766. * set print symbol-filename:            Print Settings.
  767. * set print union:                      Print Settings.
  768. * set print vtbl:                       Print Settings.
  769. * set prompt:                           Prompt.
  770. * set radix:                            Numbers.
  771. * set remotedebug:                      Protocol.
  772. * set remotedebug:                      MIPS Remote.
  773. * set retransmit-timeout:               MIPS Remote.
  774. * set rstack_high_address:              Registers.
  775. * set screen-height:                    Renamed Commands.
  776. * set screen-width:                     Renamed Commands.
  777. * set sevenbit-strings:                 Renamed Commands.
  778. * set symbol-reloading:                 Messages/Warnings.
  779. * set timeout:                          MIPS Remote.
  780. * set unionprint:                       Renamed Commands.
  781. * set variable:                         Assignment.
  782. * set verbose:                          Messages/Warnings.
  783. * set vtblprint:                        Renamed Commands.
  784. * set width:                            Screen Size.
  785. * set write:                            Patching.
  786. * setting variables:                    Assignment.
  787. * setting watchpoints:                  Set Watchpoints.
  788. * set_debug_traps:                      Stub Contents.
  789. * share:                                Files.
  790. * shared libraries:                     Files.
  791. * sharedlibrary:                        Files.
  792. * shell:                                Shell Commands.
  793. * shell escape:                         Shell Commands.
  794. * show:                                 Help.
  795. * show addressprint:                    Renamed Commands.
  796. * show args:                            Arguments.
  797. * show array-max:                       Renamed Commands.
  798. * show arrayprint:                      Renamed Commands.
  799. * show asm-demangle:                    Renamed Commands.
  800. * show caution:                         Renamed Commands.
  801. * show check range:                     Range Checking.
  802. * show check type:                      Type Checking.
  803. * show commands:                        History.
  804. * show complaints:                      Messages/Warnings.
  805. * show confirm:                         Messages/Warnings.
  806. * show convenience:                     Convenience Vars.
  807. * show copying:                         Help.
  808. * show demangle:                        Renamed Commands.
  809. * show demangle-style:                  Print Settings.
  810. * show directories:                     Source Path.
  811. * show editing:                         Editing.
  812. * show environment:                     Environment.
  813. * show height:                          Screen Size.
  814. * show history:                         History.
  815. * show history write:                   Renamed Commands.
  816. * show language:                        Show.
  817. * show listsize:                        List.
  818. * show mipsfpu:                         MIPS Remote.
  819. * show paths:                           Environment.
  820. * show prettyprint:                     Renamed Commands.
  821. * show print address:                   Print Settings.
  822. * show print array:                     Print Settings.
  823. * show print asm-demangle:              Print Settings.
  824. * show print demangle:                  Print Settings.
  825. * show print elements:                  Print Settings.
  826. * show print fast-symbolic-addr:        Print Settings.
  827. * show print max-symbolic-offset:       Print Settings.
  828. * show print object:                    Print Settings.
  829. * show print pretty:                    Print Settings.
  830. * show print sevenbit-strings:          Print Settings.
  831. * show print symbol-filename:           Print Settings.
  832. * show print union:                     Print Settings.
  833. * show print vtbl:                      Print Settings.
  834. * show prompt:                          Prompt.
  835. * show radix:                           Numbers.
  836. * show remotedebug:                     Protocol.
  837. * show remotedebug:                     MIPS Remote.
  838. * show retransmit-timeout:              MIPS Remote.
  839. * show rstack_high_address:             Registers.
  840. * show screen-height:                   Renamed Commands.
  841. * show screen-width:                    Renamed Commands.
  842. * show sevenbit-strings:                Renamed Commands.
  843. * show timeout:                         MIPS Remote.
  844. * show unionprint:                      Renamed Commands.
  845. * show user:                            Define.
  846. * show values:                          Value History.
  847. * show verbose:                         Messages/Warnings.
  848. * show version:                         Help.
  849. * show vtblprint:                       Renamed Commands.
  850. * show warranty:                        Help.
  851. * show width:                           Screen Size.
  852. * show write:                           Patching.
  853. * si:                                   Continuing and Stepping.
  854. * signal:                               Signaling.
  855. * signals:                              Signals.
  856. * silent:                               Break Commands.
  857. * sim:                                  Simulator.
  858. * simulator:                            Simulator.
  859. * simulator, H8/300 or H8/500:          Simulator.
  860. * simulator, Hitachi SH:                Simulator.
  861. * simulator, Z8000:                     Simulator.
  862. * size of screen:                       Screen Size.
  863. * source:                               Command Files.
  864. * source path:                          Source Path.
  865. * sparc-stub.c:                         Remote Serial.
  866. * speed:                                Hitachi Remote.
  867. * st2000 CMD:                           ST2000 Remote.
  868. * ST2000 auxiliary commands:            ST2000 Remote.
  869. * stack frame:                          Frames.
  870. * stack on MIPS:                        MIPS Stack.
  871. * stacking targets:                     Active Targets.
  872. * starting:                             Starting.
  873. * STDBUG commands (ST2000):             ST2000 Remote.
  874. * step:                                 Continuing and Stepping.
  875. * stepi:                                Continuing and Stepping.
  876. * stepping:                             Continuing and Stepping.
  877. * stopped threads:                      Thread Stops.
  878. * stub example, remote debugging:       Protocol.
  879. * stupid questions:                     Messages/Warnings.
  880. * switching threads:                    Threads.
  881. * switching threads automatically:      Threads.
  882. * symbol decoding style, C++:           Print Settings.
  883. * symbol dump:                          Symbols.
  884. * symbol names:                         Symbols.
  885. * symbol overloading:                   Breakpoint Menus.
  886. * symbol table:                         Files.
  887. * symbol-file:                          Files.
  888. * symbols, reading immediately:         Files.
  889. * target:                               Targets.
  890. * target amd-eb:                        Target Commands.
  891. * target core:                          Target Commands.
  892. * target exec:                          Target Commands.
  893. * target hms:                           Target Commands.
  894. * target mips PORT:                     MIPS Remote.
  895. * target nindy:                         Target Commands.
  896. * target remote:                        Target Commands.
  897. * target sim:                           Simulator.
  898. * target sim:                           Target Commands.
  899. * target st2000:                        Target Commands.
  900. * target udi:                           Target Commands.
  901. * target vxworks:                       Target Commands.
  902. * tbreak:                               Set Breaks.
  903. * TCP port, target remote:              Debug Session.
  904. * terminal:                             Input/Output.
  905. * this:                                 Cplus expressions.
  906. * thread THREADNO:                      Threads.
  907. * thread breakpoints:                   Thread Stops.
  908. * thread identifier (GDB):              Threads.
  909. * thread identifier (system):           Threads.
  910. * thread number:                        Threads.
  911. * threads and watchpoints:              Set Watchpoints.
  912. * threads of execution:                 Threads.
  913. * threads, automatic switching:         Threads.
  914. * threads, continuing:                  Thread Stops.
  915. * threads, stopped:                     Thread Stops.
  916. * toggle-editing-mode:                  Readline Vi Mode.
  917. * tty:                                  Input/Output.
  918. * type casting memory:                  Expressions.
  919. * type checking:                        Checks.
  920. * type conversions in C++:              Cplus expressions.
  921. * u:                                    Continuing and Stepping.
  922. * UDI:                                  UDI29K Remote.
  923. * udi:                                  UDI29K Remote.
  924. * undisplay:                            Auto Display.
  925. * unknown address, locating:            Output Formats.
  926. * unset:                                Renamed Commands.
  927. * unset environment:                    Environment.
  928. * until:                                Continuing and Stepping.
  929. * up:                                   Selection.
  930. * up-silently:                          Selection.
  931. * user-defined command:                 Define.
  932. * value history:                        Value History.
  933. * variable name conflict:               Variables.
  934. * variable values, wrong:               Variables.
  935. * variables, setting:                   Assignment.
  936. * version number:                       Help.
  937. * VxWorks:                              VxWorks Remote.
  938. * watch:                                Set Watchpoints.
  939. * watchpoints:                          Breakpoints.
  940. * watchpoints and threads:              Set Watchpoints.
  941. * whatis:                               Symbols.
  942. * where:                                Backtrace.
  943. * wild pointer, interpreting:           Print Settings.
  944. * word completion:                      Completion.
  945. * working directory:                    Source Path.
  946. * working directory (of your program):  Working Directory.
  947. * working language:                     Languages.
  948. * writing into corefiles:               Patching.
  949. * writing into executables:             Patching.
  950. * wrong values:                         Variables.
  951. * x:                                    Memory.
  952. * Z8000 simulator:                      Simulator.
  953.  
  954.  
  955.